---------------------------------------------------------------- Slider VBX Control Copyright 1993 Northeast Data Corp. All Rights Reserved ---------------------------------------------------------------- Release 2.2 March 1994 This document describes the Slider Custom VBX Control. CONTENTS 1. Product Description 2. Legal Information 3. Installation 4. Usage 5. Ordering Information ---------------------------------------------------------------- 1. Product Description The Slider VBX Control is a Microsoft Windows DLL designed and implemented in compliance with Microsoft standards for interfacing with Visual Basic. The control appears to the end user as a slider similar to those used on audio/video equipment such as stereos, tuners, and amplifiers. To the application programmer, the interface to the slider is similar to the one for the MS Windows standard scroll bar. The programmer can set a range of values that will be fed back to the application as the end user adjusts the position of the slider on its scale. Being a VBX control, the programmer can add the Slider Control to the tool palette in Visual Basic. This allows use of the control in Visual Basic forms. Since Visual C++ supports use of VBX controls, the slider control can also be used in the Visual C++ environment. Use of the Slider Control in a finished application requires the Slider Control DLL (slider.vbx) to be installed with the application. This is true of all custom controls written for MS Windows. There are properties available that allow the programmer to control the behavior and appearance of the Slider Control. The slider can appear in a horizontal or vertical orientation. A horizontal slider can have top "tick marks", bottom tick marks, no tick marks, or tick marks on both the bottom and top. This is also true for vertical sliders, where tick marks are left and right rather than top and bottom. The range of the slider can be set to any range with low and high values varying from 0 to 32767. All communication between the Slider Control and the application is performed using the standard Windows message mechanism for controls. Design of the Slider Control message mechanism allows the application to continuously monitor the setting of the control. ------------------------------------------------------------------- 2. Legal Information The purchaser of the Slider Control is allowed to use it and distribute it in applications without paying any royalty, and without printing or displaying a copyright notice for the control. This only includes distribution of the Slider Control DLL (SLIDER.VBX). It does not include distribution of documentation that comes with the Slider Control. The purchaser of the Slider Control may distribute the control DLL with applications that are networked (multiple users accessing the DLL from a file server) without paying any license fees to Northeast Data Corp. ------------------------------------------------------------------- 3. Installation Create a "slider" directory on your hard disk and copy all files from the distribution disk to the directory. These files include: SLIDER.VBX SLDBACK.BMP FORM1.FRM PROJECT1.MAK THUMB1.BMP THUMBV1.BMP THUMB2.BMP THUMB3.BMP THUMB4.BMP THUMB4F.BMP THUMBV1F.BMP README.TXT PROJECT1.EXE If you have downloaded the slider.zip file from Compuserve, use PKUNZIP to extract the files into the directory. Start Visual Basic or the Visual C++ App Studio applications and use the custom control installation function to install the slider.vbx control. ------------------------------------------------------------------- 4. Usage PROPERTIES ---------- BackColor - Sets the background color. BevelInner - None (0), Inset (1), raised (2), or solid (3) BevelOuter - None (0), Inset(1), raised (2), or solid (3) BevelInnerWidth - The width of the inner bevel in pixels. BevelOuterWidth - The width of the outer bevel in pixels. BorderWidth - Width of the border in pixels. CtlName - Name of the control. DragIcon - Name of the icon that will appear when the control is dragged. DragMode - Normal or automatic. Enabled - Disables or enables the slider. FocusPict - Bitmap to use for the thumb when it has focus. This bitmap should be the same size as the ThumbPict bitmap. Height - Height of control. Index - Index of control. Left - Left position. Max - Maximum slider value. This must be greater than the minimum slider value. Min - Minimum slider value. This must be less than the maximum slider value. Picture - A bitmap you can specify for painting the slider background. This picture must be a bit map. This bitmap will be positioned at the upper right corner of the control, inside the area specified by the BorderWidth and BevelWidth. Pos - Current slider position. This must be a value between or including the current minimum and maximum values of the slider. Range - Normal (0) or Inverted (1). If inverted, a vertical slider will increase in value from top to bottom and a horizontal slider will increase from right to left. TabIndex - Control tab order. TabStop - If this is turned on (1 instead of 0), the slider can be activated by tabbing to it with the TAB key. Tag - Control tag. ThumbPict - Bitmap to use for the thumb. TickMarks - Left, right, none or both for vertical sliders. Top, bottom, none or both for horizontal sliders. TickStyle - 0 for black tick marks. 1 for inset marks, 2 for raised marks. Top - Top of control window. Visible - Visible/Invisible attribute. Width - Width of control. EVENTS ------ These events work the same way as for other VBX controls. DblClick DragDrop DragOver GotFocus KeyDown KeyUp LostFocus ThumbPos ThumbUp - Occurs when the thumb has been dragged and is released. In order to update values in your application based on the current position of the slider control, you should handle the ThumbPos AND KeyDown events. The ThumbPos event is only sent when the user drags the slider with the mouse. Cursor control keys cause the slider to move but do no send ThumbPos events - they only send KeyDown and KeyUp events. Ordering Information -------------------- To order the commercial version of the Slider Control, send a check to: Northeast Data Corp. 2117 Buffalo Rd., Suite 290 Rochester, NY 14624 The prices are: Slider VBX Control (for Visual Basic and Visual C++) - $55 Slider DLL Custom Control (for C) - $50 Both controls - $75 Source code (includes both controls) - $219 Include your phone number and Compuserve ID if applicable. In return for your check, you will get the software, a telephone number for support, and a Compuserve ID for support.